home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / fdh40.zip / FDH40.DOC < prev    next >
Text File  |  1991-12-22  |  10KB  |  250 lines
  1.  
  2.  ┌───────────┬────────────────────────────────────────────────────┬───────────┐
  3.  │ ▄▀▄▀▄▀▄▀▄ │ NO NONSENSE BBS - Westfield - NJ    (908) 654-3178 │ ▄▀▄▀▄▀▄▀▄ │
  4.  │ ▄▀▄▀▄▀▄▀▄ ├────────────────────────────────────────────────────┤ ▄▀▄▀▄▀▄▀▄ │
  5.  │ ▄▀▄▀▄▀▄▀▄ │    FILE DIRECTORY HEADER Ver4.0 by Vince Rifici    │ ▄▀▄▀▄▀▄▀▄ │
  6.  │ ▄▀▄▀▄▀▄▀▄ ├─────────────┬─────────────────┬────────────────────┤ ▄▀▄▀▄VCR▄ │
  7.  │ ▄▀▄▀▄▀▄▀▄ │ Files  10   │ Bytes  50763    │ Updated 12-22-1991 │ ▄▀▄▀▄▀▄▀▄ │
  8.  └───────────┴─────────────┴─────────────────┴────────────────────┴───────────┘
  9.  
  10.  
  11.                                   - 1 -
  12.  
  13.  
  14.         PCBoard 14.5a allows you to "break" the 79 column restriction in
  15.         DIRx files, and add a graphic header to your file directories.
  16.  
  17.         The possibilities are limitless!  This is one design I came up
  18.         with which not only looks sharp, but has the added feature of
  19.         displaying the date, number of files and number of bytes in each
  20.         directory.  All five header file colors are now configurable in
  21.         version 3.0.  Version 4.0 fixes the "out-of-string-space" error
  22.         experienced by some users when the size of a DIRx file exceeded
  23.         50k bytes.
  24.  
  25.              EXECUTE THE FILE "SAMPLE3.EXE" and "SAMPLE4.EXE TO SEE
  26.                 HOW THE FINISHED PRODUCT WILL LOOK ON YOUR BOARD.
  27.  
  28.         Files contained in this archive are:
  29.  
  30.                 FDH40.EXE   <------------- The executable program
  31.                 FDH.CFG     <------------- Sample configuration file
  32.                 FDH40.DOC   <------------- Documentation file
  33.                 FDH.HST     <------------- Revision History
  34.                 SAMPLE1.TXT <------------- Sample directory #1
  35.                 SAMPLE2.TXT <------------- Sample directory #2
  36.                 SAMPLE3.EXE <------------- Sample of the new header
  37.                 SAMPLE4.EXE <------------- Sample of the new header
  38.                 COLOR.CHT   <------------- PCB Color Code Chart
  39.                 FILE_ID.DIZ <------------- Archive description
  40.  
  41.         The program was run and tested on only one PC (my own).  It is
  42.         an AT&T 6386 WGS running at 20mhz with 2 Megs of RAM memory.
  43.         DOS5.0 is installed as the operating system. It was written in
  44.         GWBASIC and was compiled using MicroSoft's QuickBASIC Compiler
  45.         Version 4.0.  It takes approx. 40 seconds to run to completion
  46.         on my BBS, which contains 51 directories and over 5,000 Files.
  47.  
  48.         It works flawlessly on my machine, but I cannot be responsible
  49.         for any problems you may have with it running on your machine.
  50.         Please be cautious!  Make backups of your file directories
  51.         before using it the first time!
  52.  
  53.  
  54.  
  55.  
  56.                                 - 2 -
  57.  
  58.  
  59.  
  60.         The limitations of the program are as follows:
  61.  
  62.                 Maximum number of file directories = 100
  63.                 Minimum free RAM of low memory needed = 64k
  64.                 Commas cannot be used in the file descriptions
  65.  
  66.         This program utilizes the PCBoard "@X" color codes to display
  67.         both color and monochrome with PCBoard Version 14.5a.  Read the
  68.         file COLOR.CHT for a complete list of "non-blinking" color codes
  69.         which may be used on PCBoard 14.5a.
  70.  
  71.  
  72.  
  73.  
  74.         Before running the program the following conditions MUST be met:
  75.  
  76.         1. FDH40.EXE and FDH.CFG must be located in the same sub-directory.
  77.            They can be located anywhere on your disk (even on a different
  78.            drive than your PCB files).
  79.  
  80.         2. All your file directories must be named DIRx, and must be
  81.            located in the same sub-directory (usually \PCB\GEN\).
  82.  
  83.         3. You will have to create your own FDH.CFG file, or edit the
  84.            sample .CFG file included in the archive.  The filename must
  85.            remain FDH.CFG (it is hardcoded in the executable).
  86.  
  87.         4. The clock on your PC must be correct.  The date shown in the
  88.            header is generated internally.
  89.  
  90.  
  91.  
  92.  
  93.                                   - 3 -
  94.  
  95.  
  96.         CREATING THE FDH.CFG FILE
  97.  
  98.         Use any pure ASCII text editor to create the FDH.CFG file.
  99.         The size of this file will vary depending on the number of
  100.         file directories you have.  If your board's directory structure
  101.         ever changes, you can re-edit the .CFG file and the program will
  102.         still work.  All configurable items are contained in this file.
  103.  
  104.  
  105.         The FIRST LINE is simply the number of DIRx file directories
  106.         which reside on your board.
  107.  
  108.  
  109.         The SUBSEQUENT LINES contain the descriptions of all your DIRx
  110.         file directories.  Use one description per line, in sequential
  111.         order.  End all lines with a simple carriage return & line feed.
  112.  
  113.  
  114.         The NEXT THREE LINES are as follows:
  115.  
  116.                 The complete path of your DIRx files
  117.                 (path only, no filename.  Place "\" at end of path)
  118.  
  119.                 The name and location of your BBS
  120.                 (this line should be no longer than 34 characters)
  121.  
  122.                 Your BBS telephone number  (maximum 14 characters)
  123.  
  124.  
  125.         The LAST FIVE LINES are the PCB "@X" color codes for configuring
  126.         the header colors.  See the file COLOR.CHT for all the available
  127.         colors you can use.  Be sure to enter these codes in CAPS!
  128.  
  129.                 Color of the Border Lines
  130.                 Color of the Indy 500 Flag
  131.                 Color of your BBS Name and Tel No.
  132.                 Color of all the Variable Information
  133.                 Color of all Fixed Titles
  134.  
  135.  
  136.         IMPORTANT:  DO NOT USE COMMAS ANYWHERE IN THE FDH.CFG FILE!
  137.  
  138.                     THE NUMBER OF FILE DESCRIPTIONS MUST BE EQUAL TO
  139.                     THE NUMBER SHOWN ON THE FIRST LINE IN FDH.CFG!
  140.  
  141.  
  142.  
  143.                                  - 4 -
  144.  
  145.  
  146.         Here is a simple illustration of a FDH.CFG file containing
  147.         five file directories:
  148.  
  149.         5                          <------- cannot be higher than 100
  150.         DOS Utilities & Shells     <------- maximum 36 characters
  151.         Communication Programs                      "
  152.         File Transfer Protocols                     "
  153.         BBS System Software                         "
  154.         Sysop & User Utilities                      "
  155.         E:\PCB\GEN\                     <---- may be any length
  156.         NO NONSENSE - Westfield - NJ    <---- maximum 34 characters
  157.         (908) 654-3178                  <---- maximum 14 characters
  158.         @X09   <-------- Bright blue Border Lines
  159.         @X0C   <-------- Bright red Indy 500 Flag
  160.         @X0B   <-------- Bright cyan BBS Name & Tel No.
  161.         @X0A   <-------- Bright green Descriptions & File Counts
  162.         @X03   <-------- Standard cyan Fixed Titles
  163.  
  164.         All lines are ended with a simple carriage return & line feed.
  165.         Do not use any blank spaces before or after the information on
  166.         any line.
  167.  
  168.  
  169.  
  170.         PREPARING YOUR FILE DIRECTORIES
  171.  
  172.         Each of your DIRx file directories should contain only one
  173.         header line.  This is the PCB 14.5a statement which calls up the
  174.         header file when it's displayed on the board.
  175.  
  176.         Place the following statement on the first line in each of your
  177.         DIRx directories:
  178.  
  179.         %E:\PCB\GEN\DIRx.HED  <--- use the same path as your DIRx files
  180.  
  181.         This line begins with a percent (%) sign and contains the path
  182.         and file name of the header files.
  183.  
  184.         The header files are automatically created when the program
  185.         FDH40.EXE is executed.  The files are named DIRx.HED and are
  186.         placed in the same directory as your DIRx files.
  187.  
  188.         See SAMPLE1 & SAMPLE2 for a sample of my directory #1 (DIR1),
  189.         and my directory #2 (DIR2).
  190.  
  191.  
  192.  
  193.                                      - 5 -
  194.  
  195.  
  196.         GET READY TO "GO"
  197.  
  198.         After you have built your FDH.CFG file, and configured all
  199.         your DIRx files to add the PCB 14.5a calling statement, you are
  200.         ready to run FDH40.EXE.
  201.  
  202.         Please take my advice and backup all your DIRx files before
  203.         running this program for the first time.  It really should not
  204.         do any damage to the DIRx files, even if you make mistakes in
  205.         building the .CFG file.  The program merely opens the DIRx's to
  206.         count the files and the bytes and does not modify them in any
  207.         way.  If you do "mess up", just correct the errors in the .CFG
  208.         file and run the program again.  Each time the program is run,
  209.         it overwrites the old .HED files and builds completely new ones.
  210.  
  211.  
  212.  
  213.  
  214.         UPGRADING FROM VERSION 1.0
  215.  
  216.         If you are upgrading from version 1.0, make the following
  217.         changes:
  218.  
  219.         1.  Replace the file FDH10.EXE with FDH40.EXE.
  220.  
  221.         2.  Delete the file FDH10.MSK.  It is no longer needed.
  222.  
  223.         3.  Change the name of FDH10.DAT to FDH.CFG and add the last
  224.             five color code lines to the end of the file.
  225.  
  226.  
  227.                             - END of DOCS -
  228.  
  229.  
  230.  
  231.              The latest copy of FDH is always available on:
  232.  
  233.                             NO NONSENSE BBS
  234.                              Westfield, NJ
  235.                             (908) 654-3178
  236.  
  237.        If you find this program useful please send a small donation to:
  238.  
  239.                            Vincent C. Rifici 
  240.                           433 Mountain Avenue
  241.                           Westfield, NJ 07090
  242.  
  243.         My thanks to Neil Stewart, E.I.B. BBS, Hillsdale, NJ for testing
  244.         the program and reporting the "bugs" which got by me on the first
  245.         try.  Thanks to Dave Terry, SALT AIR BBS for providing all the
  246.         "nice" little features in PCBoard 14.5a which made this program
  247.         possible.
  248.  
  249.  
  250.